home *** CD-ROM | disk | FTP | other *** search
/ SuperHack / SuperHack CD.bin / CODING / GRAPHICS / THREEDOM.ZIP / README.W95
Encoding:
Text File  |  1996-08-27  |  4.0 KB  |  87 lines
  1. # @(#)README.W95 1.2   8/27/96
  2.  
  3. *******************************************************************************
  4. * Threedom: a 3D polygon renderer                                             *
  5. * (C) Copyright 1996 by Philip Stephens                                       *
  6. * (C) Copyright 1996 by the IBM Corporation                                   *
  7. * All Rights Reserved                                                         *
  8. *                                                                             *
  9. * Permission to use, copy, modify, and distribute this software and its       *
  10. * documentation without fee for any non-commerical purpose is hereby granted, *
  11. * provided that the above copyright notice appears on all copies and that     *
  12. * both that copyright notice and this permission notice appear in all         *
  13. * supporting documentation.                                                   *
  14. *                                                                             *
  15. * NO REPRESENTATIONS ARE MADE ABOUT THE SUITABILITY OF THIS SOFTWARE FOR ANY  *
  16. * PURPOSE.  IT IS PROVIDED "AS IS" WITHOUT EXPRESS OR IMPLIED WARRANTY.       *
  17. * NEITHER PHILIP STEPHENS OR IBM SHALL BE LIABLE FOR ANY DAMAGES SUFFERED BY  *
  18. * THE USE OF THIS SOFTWARE.                                                   *
  19. *******************************************************************************
  20.  
  21. Introduction
  22. ------------
  23.  
  24. Threedom is a real-time 3D polygon rendering engine.  It renders polygons as
  25. perspective-correct texture mapped surfaces, with flat shading to provide
  26. basic lighting effects.  A Z-buffer is used to implement hidden surface
  27. removal, and rudimentary culling of polygons that are trivially not visible
  28. is performed.
  29.  
  30. Threedom permits you to nagivate through 3D worlds in real-time, although
  31. collision testing and gravity has not been implemented yet.  Nagivation is
  32. available by using the following keys when the mouse cursor is positioned in
  33. the display window:
  34.  
  35.     UP ARROW    Move forward.
  36.     DOWN ARROW    Move back.
  37.     LEFT ARROW    Turn left on the spot.
  38.     RIGHT ARROW    Turn right on the spot.
  39.     a        Look up.
  40.     z        Look down.
  41.     x        Step (sidle) left.
  42.     c        Step (sidle) right.
  43.     SHIFT + key    Faster movement
  44.  
  45. The executable for Threedom, along with a small demo world and textures has been
  46. provided in the demo subdirectory.  After starting the threedom application,
  47. select the "Open world..." menu item from the "File" menu and load "demo.w3d".
  48.  
  49. Threedom uses an environment variable THREEDOM_PATH in order to locate
  50. both worlds and textures.  It will always look in the current working
  51. directory first, but if it cannot find what it needs it will then search
  52. each path listed in THREEDOM_PATH.  The syntax for THREEDOM_PATH is the
  53. same for PATH i.e. each path is seperated by a semicolon.
  54.  
  55. Compiling Threedom 
  56. ------------------
  57.  
  58. You don't have to compile Threedom if you don't want to, but if you're thinking of
  59. using the code in your own application then you'll need to know how.
  60.  
  61. I used Borland C++ version 4.5 as my development environment.  Borland C++
  62. version 4.x should be sufficient, but I can't guarentee success on versions
  63. older that this.  The makefiles I've provided will only work with Borland C++;
  64. if you want to compile the code using a different compiler, you're on your own.
  65.  
  66. Before you can compile Threedom, you need to compile a simple library that Threedom
  67. uses to create the Windows 95 GUI.  The source for this library is in the winlib
  68. subdirectory.  To compile, type the following from an MS-DOS prompt (remember this
  69. is for Borland C++ only):
  70.  
  71.     make -f winlib.mak
  72.  
  73. The source for Threedom is in the subdirectory called threedom.  To compile, type
  74. the following from an MS-DOS prompt:
  75.  
  76.     make -f threedom.mak
  77.  
  78. You may need to customise both winlib.mak and threedom.mak to tell it where the
  79. LIB and INCLUDE directories are for Borland C++.  The default settings look in
  80. C:\BC\LIB and C:\BC\INCLUDE respectively.  Look at the top of these makefiles for
  81. details.
  82.  
  83. If you have difficulty compiling WinLib and Threedom, please let me know by sending
  84. e-mail to the following address:
  85.  
  86.     philip@galaxy.bocaraton.ibm.com
  87.